home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr42 / p_eze_20.zip / INSTALL.TXT < prev    next >
Text File  |  1995-02-06  |  13KB  |  257 lines
  1.  
  2.     __________         __         .__    ________________________________
  3.     \______   \_____ _/  |_  ____ |  |__ \_   _____/\____    /\_   _____/
  4.      |     ___/\__  \\   __\/ ___\|  |  \ |    __)_   /     /  |    __)_
  5.      |    |     / __ \|  | \  \___|   Y  \|        \ /     /_  |        \
  6.      |____|    (____  /__|  \___  >___|  /_______  //_______ \/_______  /
  7.                     \/          \/     \/        \/         \/        \/
  8.                                  version 2.0
  9.  
  10.  
  11.  
  12.  
  13.               Copyright (C) 1994-1995, Software Hallucinations
  14.                              All Rights Reserved
  15.  
  16.  
  17.  
  18.  
  19.                              INSTALLATION NOTES
  20.                              ----====**====----
  21.  
  22.  
  23.  
  24.                                    INDEX
  25.                                    -----
  26.                   Section         Title
  27.                -----------------------------------------------
  28.                      1     Introduction
  29.                      2     System Requirements
  30.                      3     Upgrading From Previous Versions
  31.                      4     Before You Install
  32.                      5     Installation
  33.                      6     Possible Errors
  34.                      7     Notes For Propats 3 Users
  35.                      8     UnInstalling
  36.  
  37.  
  38.  
  39. 1. Introduction
  40. ---------------
  41.  
  42.     Thankyou for taking the time to evaluate PatchEZE. We hope that it
  43. will prove useful to you, and that it will solve any and all of your GUS
  44. patch swapping problems. We also hope that you register! A great deal of
  45. time and effort went into its design, construction, coding, and help
  46. system, so if you find that you wish to continue using it after the 14
  47. day evaluation period, please do not forget to register!!! (It's cheap!)
  48.     Consult the help file for information on registering, and for the
  49. registration form.
  50.  
  51.  
  52.  
  53. 2. System Requirements
  54. ----------------------
  55.  
  56.     PatchEZE requires approximately 7 megabytes of hard disk space for
  57. installation, as it makes copies of all the Gravis patches, and also needs
  58. some extra space for directories and a disk pool. Microsoft Windows 3.1
  59. and (obviously) a Gravis UltraSound soundcard are also needed.
  60.     Please note that for PatchEZE to run correctly, a version of the
  61. UltraSound drivers that supports multiple banks (in ULTRASND.INI) and
  62. bank switching is required. If you are unsure of this, check the comment
  63. at the beginning of ULTRASND.INI.
  64.     It is highly recommended that you have more free space than this for
  65. when you start copying large patches. (The Propats 3 set takes up roughly
  66. 19 megabytes, so hopefully disk space isn't a large concern for GUS users!)
  67.     It is also recommended that you have a fast computer and a fast hard
  68. disk. Remember that the faster your transfer rate, the quicker the install,
  69. and the faster you will be able to copy patches when using PatchEZE.
  70. PatchEZE runs nicely on a 486 machine with a fast hard drive, but will run
  71. on any machine with Windows 3.1 and a GUS.
  72.  
  73.  
  74.  
  75. 3. Upgrading From Previous Versions
  76. -----------------------------------
  77.  
  78.     If you have already installed PatchEZE, then you should still install
  79. this version in the same way as before (see section 5), except when prompted,
  80. select the Upgrade installation type. This copies the new files and performs
  81. any new initialization required, whilst ensuring that your old configuration
  82. is not accidentally overwritten.
  83.     Please note that if you select the Full Install option by mistake, you
  84. may click the Cancel button when prompted for the installation directory.
  85. (If you are upgrading from any version after version 1.01, then you should
  86. not have to enter an installation directory unless PatchEZE can't find the
  87. old install files.) If you have selected a Full Install and don't cancel
  88. at the installation directory stage, don't just click the Cancel button
  89. when asked for which patch management system to install. Your old
  90. configuration has already been lost, and you WILL need to complete the
  91. full installation.
  92.  
  93.  
  94.  
  95.  
  96. 4. Before You Install
  97. ---------------------
  98.  
  99.     Installation should be smooth and error-free if you have not changed
  100. anything after installation of the UltraSound software. The three important
  101. things to check are:
  102.               - No custom patches or "propatches" are installed
  103.               - All filenames in ULTRASND.INI refer to the normal
  104.                 Gravis patches
  105.               - Patches are in the MIDI subdirectory of the directory
  106.                 specified in your ULTRADIR environment variable
  107.  
  108.  
  109.  
  110. 5. Installation
  111. ---------------
  112.  
  113.     PatchEZE is self installing. This means that the first time you run
  114. the program, it will take you through its installation, step by step. All
  115. you need to do to install is make sure all the files from the PatchEZE
  116. archive exist in the same directory on your disk. Then just run PATCHEZE.EXE
  117. from that directory by choosing Run from the File menu in Program Manager.
  118.     It is very important that you read the help section whenever a "Help"
  119. button is given during the installation process. In general, PatchEZE is
  120. not the sort of application you can figure out quickly - so it is a good
  121. idea to make frequent use of the excellent help facility.
  122.     When you are asked if you wish to set up one of the suggested patch
  123. management systems, the recommended system is the "Combination System".
  124. Whilst this creates a large and complicated directory system, it is very
  125. useful, and the best one to use with PatchEZE. You have the option of not
  126. setting up any patch management system, but please note that setting one
  127. up manually can be quite a difficult chore.
  128.  
  129.  
  130.  
  131. 6. Possible Errors
  132. ------------------
  133.  
  134.     You may encounter errors during the installation of PatchEZE. These
  135. should be fairly self explanatory, but a brief troubleshooting guide
  136. follows.
  137.  
  138. Startup errors:
  139.     - UltraSound card not found
  140.           If you don't have an UltraSound, why are you trying to install
  141.           PatchEZE?!? If you DO have an UltraSound, this problem can
  142.           occur if your ULTRADIR or ULTRASND environment variables are
  143.           not set correctly. Consult your UltraSound documentation for
  144.           further details on setting these.
  145.     - UltraSound driver not installed
  146.           PatchEZE was unable to detect the UltraSound MIDI synth driver.
  147.           You will need to install the driver manually with Control Panel,
  148.           or run the UltraSound installation program again. (Details on
  149.           how to install drivers manually can be found in the WINDOWS
  150.           subdirectory of your ULTRADIR directory.)
  151.           Note that the input driver is not needed to run PatchEZE, but
  152.           if it isn't installed, the ability to audition patches with an
  153.           external MIDI keyboard will not be available.
  154.     - MIDI directory not found
  155.           PatchEZE requires that all Gravis patches are in the MIDI
  156.           subdirectory of the directory specified with the ULTRADIR
  157.           environment variable. This is the default directory when you
  158.           install the UltraSound software, and if you have renamed it
  159.           or moved your patches, then you have probably encountered
  160.           problems with other software. You may like to undo these
  161.           changes you have made to your system, or try reinstalling
  162.           the UltraSound software.
  163.     - ULTRASND.INI not found
  164.           This problem is most likely caused by the ULTRADIR environment
  165.           variable being incorrectly set. Your ULTRASND.INI file should
  166.           reside in the ULTRADIR directory.
  167.     - PATCHEZE.INI not found
  168.           You either do not have all of the PatchEZE files together in
  169.           the one directory, or you have run PatchEZE with a working
  170.           directory other than the one in which PatchEZE itself resides.
  171.           Refer to section 2 on installation.
  172.     - Not enough disk space available
  173.           There isn't enough disk space on the drive where your Gravis
  174.           patches reside. You need enough space on this drive to make
  175.           a copy of all these patches, as the patch working directory
  176.           MUST also be off the ULTRADIR directory. Clear some space
  177.           off this drive.
  178.  
  179. Installation errors:
  180.     - Not enough free space on drive
  181.           You do not have enough available space on the chosen drive
  182.           to install PatchEZE. Select a different destination directory,
  183.           or clear some space off that drive.
  184.     - Illegal directory name
  185.           The directory name you entered for the base directory is not
  186.           valid. Some valid directories are C:\ULTRASND\PATCHEZE and
  187.           \ULTRASND\UTILS\PATCHEZE. C:PATCHEZE would be invalid.
  188.           Any directory name using a non-existant drive letter, or an
  189.           invalid character (such as wildcards * and ?, redirection
  190.           characters < and >, the pipe character |, etc) will give this
  191.           error.
  192.     - Cannot install program files
  193.           Make sure you all the PatchEZE files are together in the one
  194.           directory, that PatchEZE is run from that directory, and that
  195.           directory is the working directory. Refer to section 2 on
  196.           installation.
  197.     - Unable to set up directories
  198.           If you try to install one of the suggested patch management
  199.           systems and receive this error, it could be for one of many
  200.           reasons. It is most likely that a disk error has occured or
  201.           that a file exists with the same name as the directory.
  202.     - Unable to create PEMIDI directory.
  203.           For some reason, the PEMIDI directory could not be created.
  204.           Possibly for a similar reason as the above error.
  205.  
  206.  
  207.  
  208. 7. Notes For Propats 3 Users
  209. ----------------------------
  210.  
  211.     When you install the Propats 3 patches, the installation program
  212. makes a directory structure, PROPATS, off your MIDI directory. This does
  213. not affect PatchEZE, but you should NOT map patches from the MIDI or
  214. PEMIDI directories, or any subdirectories of them. This obviously
  215. includes the PROPATS directories. Therefore, after you have installed
  216. PatchEZE, you may like to manually go through each subdirectory of
  217. MIDI\PROPATS and "Install" each patch to the correct instrument directory.
  218. (This is done with the "Install" button - for more information, go to the
  219. help file section "The PatchEZE display", and click the mouse button over
  220. the "Install" button on the picture shown there.)
  221.     After you have copied all the patches in this way, you can use File
  222. Manager to completely remove the PROPATS directory structure. Note that
  223. it is probably easiest if you use the "Install Button Moves File" option
  224. when copying the patches, as this will erase the original afterwards.
  225.  
  226.     As an alternative to copying all the patches with the "Install"
  227. button, you may like to simply move the entire PROPATS directory structure
  228. out of the MIDI directory to the PatchEZE base installation directory.
  229. This can be done in File Manager by clicking the PROPATS directory, and
  230. dragging it onto the PatchEZE directory.
  231.     Doing this is better than the previously suggested method if you want
  232. to be able to map the patches from Propats 3 using PatchEZE, yet still
  233. use the Propats 3 control utility to set up certain combinations of
  234. patches. (It is also much easier to move the directory structure than to
  235. manually go through all the patches and decide which instrument directory
  236. each belongs in. However, you miss out on the benefits using instrument
  237. directories can provide.)
  238.  
  239.  
  240.  
  241. 8. UnInstalling
  242. ---------------
  243.  
  244.     If you don't like PatchEZE and wish to remove it from your system,
  245. the simplest way to do so is to make sure the MIDI directory contains
  246. Gravis patches (using DIRSET or PatchEZE), and to then delete the PEMIDI
  247. directory, and the PatchEZE base directory. Of course, if you have been
  248. moving patches into instrument directories, you will probably want to
  249. check that you have other copies of any custom patches you want to keep.
  250.     If you have mapped any patches onto undefined instruments (typically
  251. percussive instruments 0-26 and 88-127), then ULTRASND.INI will have been
  252. modified. This won't cause problems for your system or the operation of
  253. your UltraSound, but if you want it completely back to normal, you may
  254. want to edit ULTRASND.INI or use the "Restore File(s)" selection from the
  255. GUS software's installation program to get back the original file.
  256.  
  257.